home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Grand Slam 3
/
Grand Slam 3.iso
/
004
/
shop225.arj
/
SHOP.DOC
< prev
next >
Wrap
Text File
|
1995-03-02
|
53KB
|
1,156 lines
Page 1 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
╔════════════════════════════════════════════════════════════════════════════╗
║ >>>>> The ShopDoor v2.25 <<<<< ║
║ ║
║ ShopDoor: A Great BBS-Teleshopping-Door for Firms,Sponsors,RegSites, etc.. ║
║ -------------------------------------------------------------------------- ║
║ ║
║ Another program written by A.S. Kerkmeester !!! ║
║ ║
║ (C) 1994,1995 Copyright by: Simplesoft Developments ║
║ ║
║ -------------------------------------------------------------------------- ║
║ ShopDoor runs with: 1) Remote Access v1.11 ║
║ 2) Remote Access v2.0x ║
║ 3) Proboard v2.0x ║
║ 4) SuperBBS v1.17 ║
║ 5) ROBO-Board v1.08 ║
║ 6) EZYCOM v1.xx ║
║ 7) PCBoard v15.xx (available in our next version !!!) ║
╚════════════════════════════════════════════════════════════════════════════╝
Updates
═══════
You can Freq updates of SHOPDOOR with the Magic-Name 'SHOPDOOR',
but you can also download it from the Official Registration-Site's.
In the file 'REGSITES.TXT' you will see a list
of all our Registration-Sites !!!
File-Distribution
═════════════════
Every new version of the ShopDoor will be hatched
also in the following File-Networks:
1) RADIST (The biggest File-Net of the World !)
2) SWBnet (Mail/File-Network)
3) SHNnet (Program-Support-Network)
If YOU want your network added to this list,
please contact us !!!!!
What is SHOPDOOR
════════════════
The ShopDoor is a unique Door on it's own, no door like this
has been made yet.
It is in fact a fully configurable menu-program
but running as a BBS-Teleshopping-Door.
Sometimes you want to know (as a Sysop) if certain screens on your
BBS are being watched and also how many times and by which persons.
With this Door you will know all that.
Shopdoor gives you the possibilities to show 1 Mainmenu and 4 Submenus.
(which can contain all 10 screens)
Page 2 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
Questions and orders can be made by the users of the Shopdoor.
They will be put in the message-database of the BBS-system.
Also it's possible to download a predefined file (like a pricelist)
and to download a specific file for each product like a GIF-file.
The ShopDoor has a DBASE-III/IV-compatible database with
various possibilities, Fax Support and many other nice things.
This package contains a complete example, which fully works after extraction.
To see how Shopdoor works. just install it in your BBS
using the manual. Run the Door in your BBS.
You will see, you will like it !
An Example
══════════
Imagine you have a sponsor, who gives you sometimes
some Hardware and more, to help you with your BBS-Hobby.
Because of this sponsoring you have some screens on your BBS
with 'advertisments' from your sponsor.
It's would be nice if you and your sponsor know which screens
are being watched.
For yourself it's useful because you will know if somebody is
looking at the 'advertisments'-screens and it's also useful for your
sponsor because he can look in the information,
created and send by the ShopDoor, and decide if it's (or not) time to
create new 'advertisments'-screens with better, newer and cheaper products.
The possibilities of the ShopManager
════════════════════════════════════
A mouse-supported program with online-help,
which has the following possibilities:
1) To configure the ShopDoor, look further in this document.
2) Viewing the file named 'SHOP.LOG'.
3) To create some statistical info from the information
from the different echomail-messages created by all installed
versions (maximum of 1,3,6,20 or 100) of the ShopDoor.
4) Database generation.
5) Database Pricelist-generation.
The possibilities of the ShopDoor
═════════════════════════════════
1) Configurable by the ShopManager.
2) Setup to a maximum of 50 different ANSI/RIP-screens.
3) Those screens will be divided in 1 Mainmenu and maximum
4 Submenus (maximum 10 screens each menu).
Page 3 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
4) In the Mainmenu there are the following standard options:
- Post a message to eg: the Firm.
- A order-menu.
- A download-option of 1 file, eg: a pricelist,
the name of this file is: 'shoplst.arj'.
- A download-option for each article:
users can download a picture (like a GIF-FILE) of the
article they selected.
The echo-areas, where these messages will be written
(one for the orders and one for the questions),
can be configured by the ShopManager.
In doing so, those messages can be send by the normal
echomail-system (mailer/tosser) to the firm (your sponsor).
* Note: If you don't want to use this mail-option:
leave the Message-AreaId field(s) empty in your setup.
Every BBS connected to use the same Door
(of the same sponsor), will see all the orders, messages and
statistics in these echo-areas.
5) All the actions taken by the users on the BBS with the ShopDoor are being
registered and as a log-message sent in the same type of echo-area
as mentioned in point 4.
6) The total of all the actions mentioned in point 4 and 5 are written
in a file named 'SHOP.STA'.
7) The logging as mentioned by point 4 and 5 is written in a
logfile which can be configured by the ShopManager.
8) Database support with various nice functions.
9) Fax support: a batchfile for your Fax-program is
created automaticcaly.
10) Netmail support: when a order has been placed, the Sysop
will receive a netmail of his/her ShopDoor Manager.
ShopDoor Menus, Screens and predefined keys
═══════════════════════════════════════════
1) The ShopDoor offers you the possibility to make your
own menu-structure, easy to configure by the ShopManager.
The online-help system of the ShopManager give you
full explanations about this.
2) There are some predefined keys:
- If a user wants to leave the ShopDoor (Mainmenu)
or a Submenu he must use the key 'X'.
- If a user wants to leave a ShopDoor screen
he must use the key '-'.
- In the Editors of the ShopDoor the user must
press CTRL-Z when he/she wants to leave the Editors.
Page 4 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
3) There are few special screen-files which are being
used by the ShopDoor:
┌─────────────────────┬─────────────────────────┐
│ Screen │ Usuage │
├─────────────────────┼─────────────────────────┤
│ SHOPUSR.ANS (.RIP) │ Order-Menu Screen │
│ SHOPMSG.AMS (.RIP) │ Message-Editor Screen │
│ SHOPPAY.ANS (.RIP) │ Payment-Methods Screen │
│ SHOPSHP.ANS (.RIP) │ Shipment-Methods Screen │
│ SHOPLOGO.ANS (.RIP) │ Firm-Logo Screen │ (Commercial version Only)
└─────────────────────┴─────────────────────────┘
You can change these screen, all the fields
(look at the examples) can be configured with
the ShopManager.
Personal-Information, Creditcards, Shipments- en Payments-methods
═════════════════════════════════════════════════════════════════
You can install the different Personal-Information items,
the Shipments- and Payments-methods with the Setup-option
of your Shopmanager. Just enable (or disable) the options
you want to use... It's possible to change the positions
from the different option-fields on the ShopDoor-Screen.
The colors and Hotkeys can be changed also.
Fax support
═══════════
You can send the order, which are be confirmed by
the users, by fax. A batchfile called 'DOFAX.BAT' will
be created when you use the Fax-option (ShopManager).
For each order a new line will be written in the
batchfile. The batchfile 'DOFAX.BAT' will
execute the batchfile 'EXEFAX.BAT' for each order.
In the batchfile 'EXEFAX.BAT' you can write your
special Fax-commands, the program 'BGFAX' is a
nice Fax-program to use for it.
An example:
┌──────────────────────────────────────────────────────────────────────┐
│ Rem ShopDoor DOFAX.BAT Fax-batchfile │
│ Rem -------------------------------- │
│ Rem First parameter %1 = Fullpath and Ordername without extension │
│ Rem Second parameter %2 = Users DataPhone number │
│ Rem --------------------------------------------------------------- │
│ Call Exefax.bat C:\RA\SHOPDOOR\EOBKMB2B 31-1177-2946 │
└──────────────────────────────────────────────────────────────────────┘
Page 5 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
┌──────────────────────────────────────────────────────────────────────┐
│ Rem ShopDoor EXEFAX.BAT Fax-batchfile │
│ Rem --------------------------------- │
│ d: │
│ cd\ra\fax │
│ MAKEFAX %1.ord %1.fax │
│ BGFAX /SEND:9600 %1.fax 31-1177-2946 Rem Send fax to the Firm │
│ BGFAX /SEND:9600 %1.fax %2 Rem Send fax to the User │
│ c: │
│ cd\ra\shopdoor │
└──────────────────────────────────────────────────────────────────────┘
The ShopDoor-Database
═════════════════════
Introduction
────────────
The ShopDoor-package offers the user a DBase-III/IV-compatible database:
- The various products the ShopDoor user has to offer
can be put in this database.
- With each product it's possible to put the salesprice, 3 different
buying-prices, the warranty-period and the product-description
in these database. The stock-amount of products from each product
can be put in the database but also article-number, (VAT) tax and
used valuta. It's also possible to add a filename for each
product, for example a picture (GIF-FILE) or something like that.
More features will be expained later in this manual.
- The database-files of the ShopDoor can be read with every
DBase-III/IV-compatible database-program.
- In the ShopDoor there are 4 database-functions available:
the 3 Memo-types and the Picklist-type, these types are using
database-screens (or: template-screens).
File-mentioning
───────────────
A database-screen of the ShopDoor has a few files inclosed :
- The database-screen itself : 'DBF???.ANS' .
- The database-textfile : 'DBF???.TXT' .
- The database-file : 'DBF???.DBF' and 'DBF???.DBT' .
For the '???' you must fill in 3 numbers, you may use '000' til '999'.
It's possible to create up to a maximum of 1000 database-screens with
inclosed database-files and database-textfiles.
So as you can see, only the extensions of the various files are
different !
Page 6 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
Database-functions
──────────────────
The Memo-types offers the possibility to show e.g. PC-Systems
of the database to the BBS-user. A BBS-user can run through
the database with some keys and e.g. look at these PC-Systems.
The Memo-types shows 1 database-record each time on the screen.
The Picklist-type offers the possibility to show e.g. a collection
of CD-Rom's to the BBS-user. A BBS-user can also run through
the database with some keys and e.g. look at these CD-Rom collection.
The Picklist-type shows a maximum of 12 database-records each time on
the screen. It's also possible to show extra information from each
record to the user: 1+17 lines, 76 characters on each line !!!
A BBS-user can, using these database-functions, select the articles
he wants to order with a key. In the order-menu (look further)
he can complete his order. The user can also download (for example)
a picture of the product the user selected.
A further explanation about the database-functions will be found
somewhere else in this manual.
The database-screens displaying these database-functions are predefined,
but it's possible to change those screens a little to give them
the own 'firm-look'.
One of the advantages of these database-functions is
that it's less work to keep the database uptodate instead of updating
the screens each time with the latest information.
With this ShopDoor-package you will have a nice example of these
database-functions. It will make things quite clear by
looking at this example !
Creating a database-screen
──────────────────────────
These database-screens (or template-screens) can be made
in the 2 known formats: ANSI and RIP.
If you want to create a database-screen it's a good idea to copy the
file 'DBF001.ANS' (or 'DBF003.ANS' or 'DBF004.ANS') for a Memo-type
from the example, and change it to your own desire. It's the same for
a Picklist-type, but using the file 'DBF002.ANS' and 'PICKMEMO.ANS' as
an example. These screens can be made/changed by every screen-editor.
Creating a database
───────────────────
The database-files 'DBF???.DBF' and 'DBF???.DBT' can be made with the
ShopManager. For each database you must create a specific text-file first.
This text-file can be made by a text-editor following a specific structure.
How this must be done will be explained now.
Page 7 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
Creating a text-file
────────────────────
It's a good idea to study the examples of the ShopDoor with
the next explanation at hand.
- Global and local Keywords and the '@'-sign :
We use keywords to enter various things in the database.
There are global and local keywords. Each keyword starts always
with the '@'-sign on the beginning of a line. After the '@'-sign the
keyword follows written in text-characters. A database-record will always
be closed with the '@'-sign, but without any character following it !
A local keyword has only effect on the database-record where it's
stand by. A global keyword has effect on all records following it,
but it can be used frequently to give e.g. records
different (VAT) taxes.
- The structure of a database text-file :
* keyword @TAX = optional
* keyword @NO_TAX = optional
* keyword @VALUTA = optional
* keyword @SHOPTYPE = not optional !!!
* keyword @MEMOSCREEN = optional
* keyword @WARRANTY = optional
* keyword @NO_WARRANTY = optional
* keyword @FGDCOLOR1 = optional
* keyword @BGDCOLOR1 = optional
* keyword @FGDCOLOR2 = optional
* keyword @BGDCOLOR2 = optional
* record 1 product-group = not optional !!!
* record 1 product-title = not optional !!!
* record 1 product-sellprice = not optional !!!
* record 1 product-description line 1 = not optional !!!
* record 1 product-description line 2 = optional
* record 1 product-description line 3 = optional
* record 1 product-description line 4 = optional
* record 1 product-description line 5 = optional
* record 1 product-description line 6 = optional
* record 1 product-description line 7 = optional
* record 1 product-description line 8 = optional
* record 1 product-description line 9 = optional
* record 1 product-description line 10 = optional
* record 1 product-description line 11 = optional
* record 1 product-description line 12 = optional
* keyword @BUY_PRICE1 = optional
* keyword @BUY_PRICE2 = optional
* keyword @BUY_PRICE3 = optional
* keyword @TRANSFER1 = optional
* keyword @TRANSFER2 = optional
* keyword @TRANSFER3 = optional
* keyword @STORAGE = optional
* keyword @ARTICLENO = optional
* keyword @GIFNAME = optional
* keyword @ (end of record 1 sign) = not optional !!!
Page 8 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
* record 2 product-group = not optional !!!
* record 2 product-title = not optional !!!
* record 2 product-sellprice = not optional !!!
* record 2 product-description line 1 = not optional !!!
* record 2 product-description line n = optional
* record 2 product-description line 12 = optional
* keyword @BUY_PRICE1 = optional
* keyword @BUY_PRICE2 = optional
* keyword @BUY_PRICE3 = optional
* keyword @TRANSFER1 = optional
* keyword @TRANSFER2 = optional
* keyword @TRANSFER3 = optional
* keyword @TRANSFER4 = optional
* keyword @TRANSFER5 = optional
* keyword @STORAGE = optional
* keyword @ARTICLENO = optional
* keyword @GIFNAME = optional
* keyword @ (end of record 2 sign) = not optional !!!
- Keyword description '@SHOPTYPE='
This keyword is an exception to the other keywords,
it must be written on top of the text-file and you may
only use it once !!!
@SHOPTYPE=MEMO
──────────────
If you write 'MEMO' after this keyword, the ShopDoor will
display each record of this database in a memo-window on a maximum of 12
lines under each other. This memo-window gives the BBS-user the possibility
to look at all the database-records using keys. You will see a maximum
of 1 record each time, but it's also possible to see the other records
by just running through the database. The format of a memo is predefined,
the exact format and the screen-positions are shown in the example-screen
called 'DBF001.ANS'. With each record you write 1 product-description
line as a minimum, but you may use a maximum of 12 product-description
lines ! Each product-description line may contain a maximum of 56
characters.
The keys which can be used by the BBS-user, for the memo-type,
running through the database are:
╓───────────────┬────────────────────────────────────────────╖
║ Key │ Function ║
╟───────────────┼────────────────────────────────────────────╢
║ 'UP' or '8' │ Go to the previous record of the database ║
║ 'DOWN' or '2' │ Go to the next record of the database ║
║ '-' │ Leave database-screen ║
║ '+' │ Order current article ║
║ '*' │ Download picture-file (if available) ║
╙───────────────┴────────────────────────────────────────────╜
Page 9 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
@SHOPTYPE=MEMO2
───────────────
If you write 'MEMO2' after this keyword, the ShopDoor will
display each record of this database in a memo-window on a maximum
of 17 lines under each other. This memo-window gives the BBS-user the
possibility to look at all the database-records using keys. You will see
a maximum of 1 record each time, but it's also possible to see the other
records by just running through the database. The format of a memo is
predefined, the exact format and the screen-positions are shown in the
example-screen called 'DBF003.ANS'. With each record you write
1 product-description line as a minimum, but you may use a maximum
of 17 product-description lines ! Each product-description line may
contain a maximum of 76 characters.
The keys which can be used by the BBS-user, for the memo-type,
running through the database are:
╓───────────────┬────────────────────────────────────────────╖
║ Key │ Function ║
╟───────────────┼────────────────────────────────────────────╢
║ 'UP' or '8' │ Go to the previous record of the database ║
║ 'DOWN' or '2' │ Go to the next record of the database ║
║ '-' │ Leave database-screen ║
║ '+' │ Order current article ║
║ '*' │ Download picture-file (if available) ║
╙───────────────┴────────────────────────────────────────────╜
@SHOPTYPE=MEMO3
───────────────
If you write 'MEMO3' after this keyword, the ShopDoor will
display each record of this database in a memo-window on a maximum
of 12 lines under each other. This memo-window gives the BBS-user the
possibility to look at all the database-records using keys. You will see
a maximum of 1 record each time, but it's also possible to see the other
records by just running through the database. The format of a memo is
predefined, the exact format and the screen-positions are shown in the
example-screen called 'DBF004.ANS'. With each record you write
1 product-description line as a minimum, but you may use a maximum
of 12 product-description lines ! Each product-description line may
contain a maximum of 72 characters.
The keys which can be used by the BBS-user, for the memo-type,
running through the database are:
╓───────────────┬────────────────────────────────────────────╖
║ Key │ Function ║
╟───────────────┼────────────────────────────────────────────╢
║ 'UP' or '8' │ Go to the previous record of the database ║
║ 'DOWN' or '2' │ Go to the next record of the database ║
║ '-' │ Leave database-screen ║
║ '+' │ Order current article ║
║ '*' │ Download picture-file (if available) ║
╙───────────────┴────────────────────────────────────────────╜
Page 10 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
@SHOPTYPE=PICKLIST
──────────────────
If you write in 'PICKLIST' after this keyword, the ShopDoor will
display each record of this database on 1 line in a picklist-window.
A picklist-window is maximum 12 lines long and gives the BBS-user
the possibility to look at all the database-records using keys.
You will see a maximum of 12 records each time,
but it's also possible to see the other records by just running
through the database. The format of a picklist is predefined, the exact
format and the screen-positions you can see in the example-screen called
'DBF002.ANS'. With each record you must write 1 product-description
line but you may use 17 more product-description lines.
The first product-description line may contain a maximum of 56 characters.
The other 17 lines may contain a maximum of 76 characters.
For more information about these extra 17 lines
look also at: 'Keyword description @MEMOSCREEN'.
The keys which can be used by the BBS-user, for the picklist-type,
running through the database are:
╓───────────────┬─────────────────────────────────────────────╖
║ Key │ Function ║
╟───────────────┼─────────────────────────────────────────────╢
║ 'HOME' or '7' │ Go to the beginning of the database ║
║ 'END' or '1' │ Go to the end of the database ║
║ 'UP' or '8' │ Go to a previous record of the database ║
║ 'DOWN' or '2' │ Go to a next record of the database ║
║ '9' │ Go one page back of the database ║
║ '3' │ Go one page further of the database ║
║ '-' │ Leave database-screen ║
║ '+' │ Order current article ║
║ '*' │ Download picture-file (if available) ║
║ 'ENTER' │ View Memoscreen ANSI/RIP file (if possible) ║
╙───────────────┴─────────────────────────────────────────────╜
- Keyword description '@MEMOSCREEN='
This a global keyword for entering a filename of a ANSI/RIP-screen.
(don't use path and extension) This Keyword you can use only with
'PICKLIST' database-screens. If you write more then 1 product-description
lines in a record of your database-text file (SHOPTYPE=PICKLIST),
the user will have the possibility to see all those extra
product-description lines in this special ANSI/RIP-screen of the product.
The format of this Memoscreen is predefined, the exact format and
the screen-positions you can see in the example-screen called
'PICKMEMO.ANS'. With each record you must write 1 product-description
line but you may use 17 more product-description lines.
The first product-description line may contain a maximum of 56 characters.
The other 17 lines may contain a maximum of 76 characters.
An example:
'@MEMOSCREEN=PICKMEMO' shows a Memoscreen (.ANSI/.RIP) file to use
in combination with a Database-Picklist-type...
Page 11 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
- Keyword description '@FGDCOLOR1=' & '@BGDCOLOR1=' (optional)
These are global keywords for entering database-text-colors of
the memo-types and picklist-type. After these keywords we write the
color as a number. An example:
'@FGDCOLOR1=15' results in foreground color WHITE.
'@BGDCOLOR1=1' results in background color BLUE.
- Keyword description '@FGDCOLOR2=' & '@BGDCOLOR2=' (optional)
These are global keywords for entering the colors of the
Memo-fields (price,(VAT) tax,warranty) and Picklist-cursorline.
After these keywords we write the color as a number.
An example:
'@FGDCOLOR2=0' results in foreground color BLACK.
'@BGDCOLOR2=3' results in background color CYAN.
Color-Table
═══════════
┌────────────────────────────────────────┬─────────────────────────────┐
│ Dark Colors (Foreground & Background): │ Light Colors (Foreground): │
├────────────────────────────────────────┼─────────────────────────────┤
│ Black 0 │ DarkGray 8 │
│ Blue 1 │ LightBlue 9 │
│ Green 2 │ LightGreen 10 │
│ Cyan 3 │ LightCyan 11 │
│ Red 4 │ LightRed 12 │
│ Magenta 5 │ LightMagenta 13 │
│ Brown 6 │ Yellow 14 │
│ LightGray 7 │ White 15 │
└────────────────────────────────────────┴─────────────────────────────┘
- Keyword description '@TAX=' (optional)
This a global keyword for entering (VAT) taxes for various
products in de database. After the keyword we write the (VAT)
tax-percentage in numbers, a maximum of 2 numbers before and 2 after
the decimal point. An example:
'@TAX=17.5' shows a (VAT) tax-rate of 17.5%
- Keyword description '@NO_TAX' (optional)
This is a global keyword to disable the (VAT) tax-display option
in the MEMO-Shoptype. Also there will be no (VAT) tax-value in the
pricelist and order-form (MEMO- and PICKLIST-Shoptype).
An example:
'@NO_TAX' disables the (VAT) tax-display option.
Page 12 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
- Keyword description '@VALUTA=' (optional)
This is a global keyword for entering the used valuta for the
products in the database. After the keyword we write the valuta-symbol
in a maximum of 4 text-characters. An example:
'@VALUTA=$' shows that we are using US-Dollars as valuta.
- Keyword description '@WARRANTY=' (optional)
This is a global keyword for entering the warranty-period
for the products in the database. After the keyword we write the
warranty-period in a maximum of 3 numbers.
An example:
'@WARRANTY=36' shows a warranty-period of 36 months.
- Keyword description '@NO_WARRANTY=' (optional)
This is a global keyword to disable the warranty-display option
in the MEMO-Shoptype. Also there will be no warranty-value in the
pricelist and order-form (MEMO- and PICKLIST-Shoptype).
An example:
'@NO_WARRANTY' disables the warranty-display option.
- Keyword description '@BUY_PRICE1=','@BUY_PRICE2=' & '@BUY_PRICE3='
(optional) These keywords are local and identical.
With these, you can fill in the various buying-prices of each
product in the database. After the keyword we write the salesprice
in numbers, a maximum of 9 numbers before and 2 after the decimal point.
An example:
'@BUY_PRICE1=126.75' shows that the 1st buying-price is 126.75
'@BUY_PRICE2=123.35' shows that the 2nd buying-price is 123.35
'@BUY_PRICE3=125.95' shows that the 3th buying-price is 125.95
- Keyword description '@TRANSFER1=','@TRANSFER2=','@TRANSFER3=',
'@TRANSFER4=' & '@TRANSFER5='
(optional) These keywords are local and identical.
With these, you can fill in the various transfer-costs of each
product in the database. After the keyword we write the transfer-costs
in numbers, a maximum of 9 numbers before and 2 after the decimal point.
An example:
'@TRANSFER1=15.00' shows that the transfer-costs for 1 item are: 15.00
'@TRANSFER2=20.75' shows that the transfer-costs for 2 items are: 20.75
'@TRANSFER3=30.25' shows that the transfer-costs for 3 items are: 30.25
'@TRANSFER4=32.35' shows that the transfer-costs for 4 items are: 32.35
'@TRANSFER5=35.95' shows that the transfer-costs for 5 or more
items are: 35.95
Page 13 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
- Keyword description '@STORAGE=' (optional)
This is a local keyword for entering the amount of a product in
the database. After the keyword we write, in a maximum of 10 numbers,
the amount of products on stock. An example:
'@STORAGE=256' shows that 256 items of a type of product are on stock.
- Keyword description '@ARTICLENO=' (optional)
This is a local keyword for entering the article-number of a product in
the database. After the keyword we write, in a maximum of 12 characters,
the article-number of the product. An example:
'@ARTICLENO=120AB0023C00' shows the article-number of the product.
- Keyword description '@GIFNAME=' (optional)
This is a local keyword for entering a specific filename like
a GIF-picture which can be downloaded by the user.
So, you can create pictures for each product if you want...
The user can download a picture from a product he wants
to buy and look at it OFFLINE... Nice isn't ?
After the keyword we write, in a maximum of 80 characters,
the picture-filename of the product. An example:
'@GIFNAME=c:\gifs\COMPUTER.GIF' shows a specific GIF-file of the product.
- Product-group
The product-group must be filled in, it's e.g. nescessary for the
pricelist-generator of the ShopManager !
It can exist of a maximum of 20 text-characters. For example,
your product is a CD-ROM, you fill in 'CD-ROM' as the product-group.
- Product-title
The product-title must be filled in, it's e.g. nescessary for the
pricelist-generator of the ShopManager !
It can exist of a maximum of 80 text-characters.
For example, your product is a CD-ROM, you fill in
'The newest MultiMedia-Software on CD-ROM !!!' as the product-title.
Last we will take a look at a small database text-file,
for better explanation we have put in linenumbers for each line:
01) @TAX=17.5
02) @VALUTA=$
03) @SHOPTYPE=MEMO
04) AZTEC
05) Hilltop Aztec VesaLocalbus Systems Pentium P24T upgradable
06) 2499.00
07) Mainboard 486SX 33MHz
08) RAM 4Mb
09) Harddisk 212Mb WD Caviar
10) Videocard 1Mb ALI Localbus
Page 14 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
11) 3,5" 1,44Mb Floppydrive; SVGA Colormonitor 1024*768;
12) MTek Waterresistant keyboard; 486DX with CPU cooler
13) Multi I/O: 2Ser/1Par/1Game/2FDD/2HDD-Vesa Localbus
14) @WARRANTY=24
15) @STORAGE=5
16) @BUY_PRICE1=0.00
17) @BUY_PRICE2=0.00
18) @BUY_PRICE3=0.00
19) @TRANSFER1=15.00
20) @TRANSFER2=20.75
21) @TRANSFER3=30.25
22) @TRANSFER4=32.35
23) @TRANSFER5=35.95
24) @
25) AZTEC
26) Hilltop Aztec VesaLocalbus Systems Pentium P24T upgradable
27) 2749.00
28) Mainboard 486DX 40MHz
29) RAM 4Mb
30) Harddisk 212Mb WD Caviar
31) Videocard 1Mb ALI Localbus
32) 3,5" 1,44Mb Floppydrive; SVGA Colormonitor 1024*768;
33) MTek Waterresistant keyboard; 486DX with CPU cooler
34) Multi I/O: 2Ser/1Par/1Game/2FDD/2HDD-Vesa Localbus
35) @ARTICLENO=0001C3
36) @GIFNAME=c:\gifs\AZTEC486.GIF
37) @
It's quite simple, line 1 til 3 will be clear enough.
The 1st record begins on line 4 and is closed on line 24.
The 2nd record begins on line 25 and is closed also on line 37.
Try it yourself if you understand the above example with
the help of this manual.
Creating a Pricelist
────────────────────
With the ShopManager you can create a nice pricelist.
The pricelist-generator gets all the data of your ShopDoor-Databases
and create a pricelist-file called 'SHOPLST.TXT'. We use the
file: 'LOGO_LST.TXT' for the first (optional) part of this pricelist,
you can put your firm-logo and information in it.
You can compress the file with your own 'ARJ-program' in
a file called 'SHOPLST.ARJ'.
Page 15 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
The Order-Menu System
═════════════════════
The ShopDoor has a special Order-Menu in the Mainmenu.
There are 2 ways to order something using this menu.
1) Sending a order-message to the firm is the simple way.
2) If you use the ShopDoor database-functions, the user can order
the articles he want by selecting them with a key.
In the Order-Menu he can fill in his personal information,
his payment-method and his transfer-method.
He can take a look and/or download his bill also.
Of course is it possible for the user to cancel or to confirm is order.
When a user confirmed his order, the bill will be placed in the
ShopDoor Echomail-Board as a message to the firm automaticcaly.
The bill will be written on your harddisk with a unique filename
and extension '.ORD'. The bill can be print out for example.
Creating a Bill
───────────────
You can give a bill your own 'look' using 3 text-files.
We use the file: 'LOGO_ORD.TXT' for the first (optional) part
of the bill, you can put your firm-logo and information in it.
We use the file: 'HEADER.TXT' for the second part of the bill.
We use the file: 'FOOTER.TXT' for the last part of the bill.
In these text-files we can write firm-text but also the
bill-informations using code-words. Underneath follows a
table with those code-words, a explanation and where it can
be used. You can find these 3 text-files in the demo-archive.
It will make things quite clear by looking at these files !
┌───────────────────────────────┬────────────────────┬─────────────────┐
│ Information │ Code-word │ Can be used in │
├───────────────────────────────┼────────────────────┼─────────────────┤
│ Date │ @DATE@ │ HEADER.TXT │
│ Name │ @NAME@ │ HEADER.TXT │
│ Organisation │ @ORGANISATION@ │ HEADER.TXT │
│ Clientnumber │ @CLIENTNO@ │ HEADER.TXT │
│ Address │ @ADDRESS1@ │ HEADER.TXT │
│ Zipcode │ @ADDRESS2@ │ HEADER.TXT │
│ Location │ @PLACE@ │ HEADER.TXT │
│ Country │ @ADDRESS3@ │ HEADER.TXT │
│ Voice Phone │ @VOICE@ │ HEADER.TXT │
│ Data Phone │ @DATA@ │ HEADER.TXT │
│ Fax Phone │ @FAX@ │ HEADER.TXT │
│ Nodenumber(s) │ @NODE@ │ HEADER.TXT │
│ Shipment Method │ @SHIPMENT@ │ HEADER.TXT │
│ Payment Method │ @PAYMENT@ │ HEADER.TXT │
│ CreditCard Number │ @CARDNO@ │ HEADER.TXT │
│ CreditCard Exp.Date │ @EXPDATE@ │ HEADER.TXT │
│ Transfer Costs (no (VAT) tax) │ @TRANSFER@ │ FOOTER.TXT │
│ Costs bill (no (VAT) tax) │ @SUBTOTAL@ │ FOOTER.TXT │
│ Tax bill │ @TAX@ │ FOOTER.TXT │
│ Total Costs bill │ @TOTAL@ │ FOOTER.TXT │
└───────────────────────────────┴────────────────────┴─────────────────┘
Page 16 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
These files are coming with the ShopDoor-package
════════════════════════════════════════════════════════════════════════════
1) README.NOW : A text-file with the latest news...
2) SHOP.EXE : The ShopDoor for the BBS.
It's very easy to install the ShopDoor in
your BBS-system, just start your BBS-setup program
and add a new menu-item. Look further in this manual for
some examples for different BBS-systems...
Note: The node-number will be detected automaticcaly by
the ShopDoor, but you can overrule this by using the
environment-variable 'TASK'. This works with almost all
the supported BBS-systems except the SBBS-system.
ROBO-Board has the same option, but the ROBO-Board
environment is called 'NODE'. An example: you are running
node 47, so place the following line in your
BBS-batchfile: SET TASK=47 (or: SET NODE=47).
3) SHOPMGR.EXE : The ShopManager used for the ShopDoor.
4) ????????.LOG : Will be made automatically: the logfile from the Door,
all actions off the users will be written in it.
The filename of this logfile can be configured
by the ShopManager.
5) SHOP.CFG : Will be made automatically: the cfgfile from the Door,
6) SHOP.CTL : Will be created by the ShopManager:
the operation-file where the ShopDoor works at.
7) SHOP.DOC : This text-file.
8) EXAMPLE1.ARJ : An example from an installed ShopDoor,
unpack the file 'EXAMPLE1.ARJ' in the same
directory were you have put the package.
And go and try the ShopDoor and the ShopManager !
9) SHOP???.ARJ : Language Archive-files.
10) REGFORM.FRM : Registration-form: please fill in !!!
11) REGSITES.TXT : Registration-Site's, prices and payment-methods.
12) PROBLEMS.TXT : Text-file with some problems and sollutions.
13) MULTLINE.TXT : Text-file with a complete example of a
multi-Line-BBS (RA 2.02) and 2 nodes.
14) INSTALL.TXT : Text-file with info to install the ShopDoor FAST.
Page 17 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
15 EXTRACT.ARJ : An Extraction program for 'TSHOP' and ShopDoor.
16 DISK.TXT : SHOPDOOR-DISK Service !!!
17 TECHSUP.EXE : A nice program :-)
Language-selection
══════════════════
With this package 9 languages are available:
Dutch, English, German, Spanish, Brazil, Portuguese,
French, Swedish and Turkish.
To select a language just choose the right archive-file and unpack it.
Dutch : 'SHOPNL.ARJ'
English : 'SHOPUK.ARJ'
German : 'SHOPD.ARJ'
Spanish : 'SHOPSP.ARJ'
Brazil : 'SHOPBRA.ARJ'
Portuguese : 'SHOPPG.ARJ'
French : 'SHOPF.ARJ'
Swedish : 'SHOPSWE.ARJ'
Turkish : 'SHOPTRK.ARJ'
Page 18 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
ShopDoor Installation
═════════════════════
An example for Remote Access:
╒══════════════════════════════════════════════════════════════ Edit Menu Item ╕
│ │
│ 1 2 3 4 5 6 7 │
│ 123456789012345678901234567890123456789012345678901234567890123456789012345 │
│ ; │
│ │
│ d:\ra\shopdoor\shop.exe *M │
│ │
│ Action Execute sub-program (Type 7) │
│ Display │
│ OptData │
│ HotKey X │
│ AutoExec No │
│ Colour Colour example │
│ │
│ MinSec 0 TimeUsed 0 FlatCost 0 │
│ MaxSec 0 TimeLeft 0 TimeCost 0 │
│ A flags -------- Age 0 Terminal Any │
│ B flags -------- MinSpeed 0 Nodes │
│ C flags -------- MaxSpeed 0 │
│ D flags -------- Credit 0 │
│ │
│ │
╘══════════════════════════════════════════════════════════════════════════════╛
(for a multi-line system: take a look at the file 'MULTLINE.TXT')
Page 19 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
ShopDoor Installation
═════════════════════
An example for Ezycom:
╒═══════════════════════════════════════ Ezycom Menu Editor 1.02 TOP.MNU ═════╕
│ Display : ;▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
│ Data : e:\ezy\shopdoor\shop.exe *M │
│ │
│ Menu Type : 7 Time Online : 0 │
│ Hotkey : X Start Time : 0 │
│ Automatic : No End Time : 0 │
│ Security : Greater than/equal to Node : 0 │
│ 0 Baud : 0 │
│ Flags : -------- Filepoints : 0 │
│ -------- Test Age : No │
│ -------- Test Post/Call : No │
│ -------- Test Kilobytes : No │
│ Foreground : Light Gray Test Files : No │
│ Background : Black Local Only : No │
├──────────────────────────────────────────────────────────────────────────────┤
│ Command : 7, Run Program In DOS Shell │
╘══════════════════════════════════════════════════════════════════════════════╛
Page 20 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
ShopDoor Installation
═════════════════════
An example for Proboard:
╔══════════════════════════════════[ UTIL ]══════════════════════════════════╗
║ 0 1 2 3 4 5 6 7 ║
║ 12345678901234567890123456789012345678901234567890123456789012345678901234 ║
║ [^X^] ShopDoor Demo░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
║ ║
║ Color : Bright Yellow on Blue Example Text ║
║ ║
║ Hotkey : X ║
║ Function : 7 - Shell ║
║ Data : d:\pb\shopdoor\shop.exe ║
║ ║
║ Min.Level: 0 ║
║ Max.Level: 0 ║
║ Flags : -------------------------------- ║
║ Min. Age : 0 ┌─RIP──────────────────┐ ║
║ Max. Age : 0 │ Show remote : Yes │ ║
║ Sex : Don't Care │ Show local : Yes │ ║
║ Time Left: 0 │ Reset screen : Yes │ ║
║ Time Onl.: 0 └──────────────────────┘ ║
║ Timeframe: Fully enabled ║
║ Min.Speed: 0 ║
║ Max.Speed: 0 ║
║ ║
╚════════════════════════════════════════════════════════════════════════════╝
Page 21 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
Note
════
The author and distributers of the software-package 'ShopDoor'
can't be in any way made responsable for any damage in any form,
orginated from the use of the 'ShopDoor'.
SHOPDOOR can be used by everyone, but at his/her own risk !
Registration
════════════
The ShopDoor and the ShopManager can only be used fully
if you register the package.
There are a few registration-possibilities,
look for more information about this (and more)
into the file called 'REGSITES.TXT'.
After your registration you will receive a keyfile for
the ShopManager and (a) key(s) for the ShopDoor for
your own BBS-system(s).
╔════════════════════════════════════════════════════════════════════════════╗
║ Shareware usuage: ║
║ ───────────────── ║
║ When you have a 3,6 or 20-key shareware registration, you also have the ║
║ possibility to receive 2,5 or 19 more ShopDoor-keys for different ║
║ BBS-systems, extendable with the same ShopDoor and info-screens. ║
╚════════════════════════════════════════════════════════════════════════════╝
╔════════════════════════════════════════════════════════════════════════════╗
║ Commercial usuage: ║
║ ────────────────── ║
║ If you are a official (commercial) firm, you need ║
║ to buy the commercial version. ║
║ ║
║ The commercial version has all the options of the ║
║ Shareware-version of course. ║
║ ║
║ Some extra options are: ║
║ - No limits at all. ║
║ - Official ShopDoor Diskette & Printed Manual. ║
║ - No ShopDoor Logo visible when entering the ShopDoor. ║
║ - New Commercial options in the future... ║
║ - If you have made the screen 'SHOPLOGO.ANS' (.RIP), ║
║ this screen will be displayed automatically and will ║
║ disappear after a little pause. ║
╚════════════════════════════════════════════════════════════════════════════╝
Page 22 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
You will receive these keys on request from A.S. Kerkmeester,
after completing the form shown below.
Without the registration the program will only work as a demo !
The unregistered ShopDoor-user has the following restrictions:
- The following ShopDoor-functions doesn't work:
* Download pricelist
* Download product picture
* Statistics-generations
- It's not possible to change the menu-structure with the ShopManager.
- The ShopDoor displays only a maximum of 20 database-records
at a database-screen.
- Orders & Messages will not be processed,
but a short message will be placed in the Firm-MailBoard
after quiting the ShopDoor. (so you can test the messagebase-system)
Look in the file 'REGSITES.TXT',
choose a Registration-Site and pay the money
at the account of that Registration-Site if possible.
Otherwise pay the money at the account of the
Dutch Distribution-Site.
After receiving the registration-money and after completing
(and sending) the form (file: 'REGFORM.FRM'), the keys
will be sent to you.
Please send the form to your Registration-Site by netmail.
For all your questions contact 1 of our named Registration-Sites.
Page 23 of 23 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ SHOPDOOR - MANUAL
Many thanks to our team:
═══════════════════════════════════════════════════════════════════════════
Ettie Kerkmeester (Netherlands) : Manual checking and Support...
Thonie Weststrate (Netherlands) : Beta-testing...
Laurent Grinsven (Netherlands) : Beta-testing...
Mike Foedisch (Germany) : Beta-testing and German translations...
Sergio Creimer (Brazil) : Brazilian Translations...
Eduard Frankes (Netherlands) : Beta-testing...
Eric Kauffeld (Netherlands) : Beta-testing...
Pedro Metello (Portugal) : Portuguese Translations...
Sikko de Graaf (Netherlands) : RIP hints & tips
Mariano Urquiza (Argentina) : Spanish Translations...
Felix Mueller (Germany) : Beta-testing...
Martin Alexanderson (Sweden) : Swedish Translations...
Jan Degryse-M.D. (Belgium) : French Translations...
Rob Vermeule (Netherlands) : Beta-testing...
Bill Brooks (USA) : English Checking...
E.Onder Kokturk (Türkiye) : Turkish Translations...
Ton van den Broek (Netherlands) : Beta-testing...
Ruud van Munster (Netherlands) : Beta-testing & Ezycom Support...
Gerard Konning (Netherlands) : Beta-testing & PCBoard Support...
──────────────────────────────────────────────────────────────────────────────
(Note: This manual must be printed with a Page-length of 66 characters...)